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This article describes the features of a marveicus disk 
operating system called CP/M. The combination of 
CPIM and an 8080 or Z-80 microprocessor produces a 
system that approaches the versatility of large com- 
puters. I have not written this article to be an operating 
manual, but rather to be a complement to the extensive 
documentation that accompanies CP/M. In particular, I 
will try to help you avoid the frustrating errors I made at 
the beginning. Part of the problem is that there is so 
much to learn and there is so much information in the 
manuals. I hope that this article will smooth the way for 
you. If you still have a problem, you might contact the 
people either at Digital Research or Lifeboat Associates 
i have round both to be very helpful. If all else fails, con- 
tact me and I'll try to help. 

INTRODUCTION 

Every computer needs a system monitor which, at the 
very least, will coordinate communication between the 
computer and the peripherals (keyboard, printer 'video 
screen, tape recorder, floppy disks, etc.). This monitor 
should be able to perform such housekeeping tasks as 
displaying memory in hexadecimal and ASCII, moving a 
block of memory, filling memory with a constant, com- 
paring one block of memory to another, and the ability 
to jump to another program in memory. 

Over the past several years, INTERFACE AGE has 
published articles addressed to one or another of these 
tasks. By combining the ideas in these articles, it is 
possible to produce a decent, non-disk monitor. If you 
have a floppy disk, you need something more. 

Floppy disks usually come with a minimal disk oper- 
ating system (DOS) that will perform only a few of these 
tasks. For example, the jump command is the only non- 
disk operation available in the North Star DOS. The 
PerSci intelligent controller has only disk-oriented com- 
mands. The user, therefore, will have to write the neces- 
sary non-disk monitor commands and integrate them in- 
to the DOS. This task will be much easier if you have an 
assembler available. You will also want an editor to 
change the assembler file, and maybe even a debugger 
to find the problem in the resulting machine code when 
it doesn’t do what you expected. n 
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The people at Digital Research' have nicely combined 
lust about all of the features that you could possibly 
want into an 8080 disk operating system called CP/M. 
The basic system is available on an 8-inch soft-sectored 
floppy diskette for $100. The price includes a compre- 
hensive set of operating manuals. A version of CP/M is 
also available for the North Star 5-inch floppy from Life- 


Table 1. The cost of CP/M programs. 
Program 8” Disk 

CP/M $100 

MAC 90 

SID 75 

BASIC-E 32 

CBASIC 100 

BASIC (Microsoft) 300 

FORTRAN 400 


THE CP/M MONITOR 

CP/M can be divided into several subsystems: 

BIOS — The basic I/O (except disk) 

BDOS — The basic disk operating system 
CCP — The console command processor 
TPA — The transient program area (user programs) 

BIOS is the program that interfaces your non-disk per 
pherals to CP/M. Your first task is to write your own cus 
tomized version of BIOS and copy it onto the CP/M disk 
ette. This will be discussed in detail in a later section. 
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The BDOS section takes care of all disk operations for 
up to four floppy disks. It maintains the file directories 
and the allocation of sectors. Floppy diskettes are divided 
into a number of concentric tracks, and each track is fur- 
ther divided into a number of sectors. All but the smallest 
programs require more than one sector. An operating sys- 
tem that stored data on contiguous sectors would be very 
inefficient. This is because the overhead in switching 
from one sector to the next causes the system to just 
miss the next sector. The system then has to wait until 
the desired sector comes around again. CP/M solves the 
problem by staggering the data (from multiple-sector 
files) throughout the diskette. This gives the system a 
little more time between the end of one sector and the 
beginning of the next. Of course, all this manipulation is 
not apparent to the user. 

STARTUP 

After you have customized your version of CP/M and 
loaded it into memory (as discussed later in this article), 
it can be started up by branching to address zero. The 
prompt A> appears at the console, indicating that CP/M is 
ready for commands and that drive A is the default drive. 


Some commands will also accept 
ambiguous file names as a reference 
to a group of files. The asterisk 
and question mark are used for this 
purpose. The * stands for any 
number of characters; the ? for only 
one. Thus the ambiguous file 
name *,* refers to all files on the disk. 


THE BUILT-IN COMMANDS 

Several commands, built into CP/M, can now be given: 

DIR List directory of files 

ERA Erase file(s) from disk 

REN Rename a file 

SAVE Copy a file from memory to disk 

TYPE Print out a file 

Keyboard entries can be edited with the following 
commands ('X means Control-X): 

A U Cancel the current line 

DEL Delete the last character 

A R Retype the current line 

A E Local carriage return (don’t send it) 

Other special commands are: 

A C Restart CP/M (warm start from address zero) 
A P Output to list device (toggle on and off) 

A S Freeze/scroll the display (toggle) 

The DIR command, without arguments, lists the entire 
directory on the default drive. An argument may also be 
given to list only a portion of the directory or to specify 
the disk drive. 



FILENAMES 

File names may be ambiguous or unambiguous. Un- 
ambiguous file names may have three parts: the disk 
name, the primary name, and the file type. The following 
are examples of unambiguous file names: 

B:SOLVIT.ASM 

A:LINEAR.HEX 

LOGGING.DAT 

B:MAR2878 

The drive name appears first, followed by a colon. If 
the file is on the default drive, then the drive name is op- 
tional. The primary name must start with a letter and 
may contain up to eight characters. The file type is used 
to designate the nature of information in the file. It is 
preceded by a decimal point. 

Some file-types are reserved by the system: 

ASM Assembler source file 
Intel HEX object file 
Print file of assembly listing 
Command file (binary executable file) 

BASIC source file 
Intermediate BASIC file 
Backup file from prior edit 
Library source file that can be inserted ■ 
during editing 

A list of commands to be executed 
Datafile 

Temporary work file 

The user can also invent other names, e.g., TXT for text. 

Some commands will also accept ambiguous file 
names as a reference to a group of files. The asterisk 
and question mark are used for this purpose. The 
stands for any number of characters; the ? for only one. 
Thus the ambiguous file name refers to all files on 
the disk. The name INVER.* refers to all files with the 
primary name INVER, while *.HEX refers to all HEX files. 
Files named 

NEWTON1.HEX 

NEWTON2.HEX 

NEWTON3.HEX 

can be collectively referred to by 
NEWTON?. HEX 


HEX 

PRN 

COM 

BAS 

I NT 

BAK 

LIB 


SUB 

DAT 

$$$ 


THEDIR AND ERA COMMANDS 

The commands DIR and ERA both accept ambiguous 
file names. Examples are: 

Dl r List entire directory on default drive 

DIR B: List entire directory on drive B 

DIR'.ASM List all assembler source files 

DIR B:PROM.* List all files on drive B with primary 
name PROM 
DIR*.* SameasDIR 


The ERA command is used to erase files and takes 
the same arguments as the DIR command. As a precau- 
tion against a potentially catastrophic error, the com- 
mand ERA *.*. requires verification. The user must 
answer the question: Y/N?. Of course, unambiguous file 
names can be used with the DIR snd ERA commands to 
referenceasinglefile. _ 
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B>DIR '.ASM Youtypethis 
B.-LIFE.ASM CP/M responds with this 
B>DIR A:* - . ASM Youtypethis 
A:FITTER.ASM CP/M types this 
B>A; Switch back to A 

A> A is.now thedefault drive 
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THE REN, TYPE, AND SAVE COMMANDS 

The REN, TYPE, and SAVE commands require the use 
of unambiguous file names. To rename a file, type the 
new file name, an equals sign, and the original die name 
(i.e., the names appear to be reversed). As we shall see 
in the next section, the editor gives the original file 
name to the new file. It then saves the original" version, 
but changes its file type to .BAK. If this file were edited 
a second time, the original file would be lost. This oc- 
curs when the editor renames the intermediate file to 
type .BAK. and the newest version to .ASM. All three ver- 
sions can be saved if the .BAK file is renamed Pefore the 
second edit: 


are duiii inio me uur part or CP/M. The other commands 
we will consider are separate programs. Their names ap- 
pear separately in the directory listing, and can be 
removed if they are not needed. 


SUBMI 

DUMP 

LOAD 

PIP 


These transient programs will be discussed in the fol 
lowing sections. 


DISK STATUS 

The program STAT.COM can be i 
area of each diskette. The command 


Now after the second edit, there will be 
files of types .ASM, .BAK. and .BK2. 

The TYPE command is used to list files on i 
or list device. (Typing a 'P alternately turns 
the output to the list device. It always app 
console./ 

The SAVE command is used to copy progr; 
from memory. The command: 


A>STAT 8 


BYTES REMAINING GN 6:27 K 

The STAT command will produce a c 
alphabetical order and give the size 
command is: 


SAVE 10 B:TABL.COM 


will save on disk 3 a binary file ten pages 256-byte 
blocks, long. The program must start at 100 -EX. the 
beginning of the transient program area (TPA). T he SAVE 
command is useful for saving an altered version of a 
binary program. It is also useful for transferee vour old 
source 'iies to ASM. (More about this later.) 

CHANGING DISKS 

References to files stored on the default drive need 
not include the drive name: 


A>STAT B: 


Disk drives can be software write protected with the 
command: 


STAT B: = R/O 

A warm start i'C) will cancel the protection. Also the 
default drive cannot be write protected. 

THE TEXT EDITOR 

Disk files are created and altered with the command: 

A>ED filename.type 

A * prompt will appear, indicating that the editor is 
ready for commands. If you are creating a new file, type 
an I (for insert) and a carriace return <CR>. All of the 
next lines will be entered into the edit buffer in memory. 
At the end of the test, type a Control-Z (*Z) and the * 
prompt will reappear. The text you have written can now 
be displayed or altered. The commands you can use 
make reference to an imaginary character pointer (CP) 
that is positioned between two adjacent characters in 
the edit buffer. Some of the commands move the CP 
others manipulate the text with respect to the CP. 

MOVING THECHARACTER POINTER 

The pointer is set to the beginning of the buffer with a 
B and to the end with a — B. A command ot C moves the 
CP one character forward (towards the end of the buf- 
fer). The CP can be moved to the beginning of the next 
line with an L. The pointer-movement routines don't pro- 
duce any output, so you can't see what is actually hap- 
pening. In the next section we will introduce additional 
commands for viewing the text. Either the C or L com- 
mands can be preceded by a decimal number to move 
the CP more than one location. If the number is nega- 
tive, the pointer moves backwards. A 0L command sets 
the CP to the beginning of the current line. These com- 
mands are summarized in Table 2. 


A>TYPE SOLVIT. ASM 
A>TYPE A:LINFIT.FOR 


The default drive can be changed by typing the new 
drive name followed by a colon: 


A>B: Youtypethis 

B> The system responds with th 


Now commands that refer to disk B need not be preced' 
ed with the drive name. Of course, references to files on 
drive A must be preceded with an A:. 
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1 Table 2. 

Editor commands that move the pointer. 

i Command 

moves the pointer 

B 

to the beginning of the edit buffer 

-B 

totheend of the buffer 

nC 

n characters forward 

— nC 

n characters backwards 

nL 

to the beginning of the nth line 

i — nL 

backwards n lines 

0L 

to the beginning of the current line 


VIEWING THETEXT . .. . 

The T command can be used to view (Type) lines ot 
the edit buffer. Typing a single T, displays the text from 
the CP to the end of the line. A OT, prints text from tne 
beginning of the line to the CP. Since commands can 
qenerally be combined, the command OTT types the en- 
tire line that the CP is on. A positive or negative decimal 
number may precede T as with the C and L commands 
The editor can be made to simulate a llne ;° n ® nt ®^ 
editor. Typing just a carriage return will move the CP to 
the beginning of the next line and print that line. This is 
equivalent to entering an LT command. Of course suc- 
cessive lines can be viewed by repeatedly typing a car- 
riage return <CR>. 

Text can be altered, inserted, or 
replaced. The n D command deletes 

n characters after the CP if n is 
positive. If n is negative, the n 
characters before the CP are deleted. 


Typing a decimal number n and a <CR> will move the 
CP n lines and print out the new line. Each prior line can 

be viewed by typing a— 1<CR>. T mm 

If scrolling is too fast during execution of the T cot 
mand. you can type a Z or two. This slows down the 
display (sleep Z-Z-Z). 

ALTERINGTHETEXT Th» n n 

Text can be altered, inserted, or rep aced. The n D 
command deletes n characters after the CP f n , s 
positive. If n is negative, the n characters before the XP 
are deleted. The nK command is similar, except t 
deletes (kills) n lines of text starting the the C . 
Characters are inserted after the CP with the I com- 
mand The insert mode is terminated either with a Z ora 

<CR>. The latter is used if both a <c R> and . 1 1 
are to be inserted into the edit buffer. Otherwise the Z 
is used. These additional commands are summarized in 
Table 3. ^ 

Table 3. Edit commands that operate on the text 

T Display from CP to end of line 

OT Display from beginning of line to CP 

Z Slowdown scroll speed (sleep) 

nD Delete n characters after the CP 

— nD Delete n characters before the CP 

nK Delete n lines (kill) 

_nK Delete n lines before the CP 

—I Insert text after the CP 

<CR> Move the CP to next line and print it 

n Mtnup the CP n lines and print the last 


THE FANCY COMMANDS 

There are several fancy commands. Typing an F<string> 
will move the CP to the end of the string. A decimal num- 
ber may precede the F to find the nth occurrence of the 
string. Notice that the F command doesn’t change the 
text. The search/substitute command is often the best 
method of changing a passage. The format is nS<old 
string> A Z<new string> (the angle brackets are not ac- 
tually entered). This command will change the next n oc- 
currences of the old string to the new. Carnage return/ 
line feed pairs are represented in the string by a Control-L. 

The X command can be used to block move a portion 
of text. Typing an 8X, for example, will copy the eight 
lines after the CP to a temporary disk file. You then 
move the CP to the new position and type the R com- 
mand. The eight lines are then copied from the disk file 
to the new location in the edit buffer. Finally, there is an 
M (macro) command that can be used to repeatedly exe- 
cute the rest of the command line. Examples of these 
commands are given in Table 4. 


Table 4. Fancy edit commands. 

2FCALL'Z0TT Find the 2nd occurrence of CALL 
and print the line it is on 

MS” a Z’*Z 0TT Change every occurrence of 1 to 
and print the new lines 


When you have finished editing the text, type an E<CR> 
(End). The edit buffer will be copied to disk and control 
will return to CP/M. 

EDITING EXISTING FILES . _ t 

In the previous section, we were talking about creat- 
ing and editing a file. The editing of an existing file (on 
disk) is a little different. Give the same initial command: 


ED filename.type 

But if you then give the BT commands to move the 
pointer to the beginning of the file and pnnl . the firs 
line, all you get is the ’ prompt In fact any of the above 
commands will only produce a prompt The Probiem is 
that the edit buffer is empty. (This prob lem didn t o :cu 
before, because we were creating the fite directly 'in 
edit buffer.) The answer is to append some text from the 

01 FHesVmall enough to be contained in the edit buffer 
can be loaded with the command #A. The # sign stands 
for 65535 and can be used for any command that needs 
f a°deoima 5 , number. Now that the entire the i— 
it can be displayed with the command B#T. Edit the ext 
then type an E to end the edit. The new version will be 
copied back to the disk and given the original name. The 
original version is saved too; its file type is changed to 

B Disk names can be used in the ED wjmnwid' to 
snecify where to get the editor, where to set the original 
file, and where to place the final version. The command. 

A>B:ED A.FORCE.ASM C: 

will load the editor from drive B, the original file ^ 
disk A and put the edited version on disk C. In this case, 
C will become the default drive at the end of the edit. 
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The E command is then used to end the edit. Any text 
remaining in the edit buffer is copied to the new disk file 
(thus it is not necessary to give a #W command prior to 
the E command). Then any lines left in the original disk 
h e are copied to the new file. The new file is given the old 
file name and the old file type is changed to type .BAK. 

LIBRARY FILES 

You probably have sections of assembly language code 
that you frequently use. such as I/O routines and HEX- 
bmary/binary-HEX conversions. These routines can be 
placed into a disk file of type .LIB and subsequently in- 
serted into another file that is being edited. The command: 
•BHEXBIN 

copies the file H EXBIN. LIB from disk into the edit buffer 
starting at the CP. 

theassembler 

.J' assembler operates on disk files of type 
' ■ It can produce an assembly listing file (a combi- 

"° ASC " HEX cod e and the original source listing) 
with the file type .PRN (print). It is called a print file, be- 
cause it is useful only for humans. Computers have no 

inmfi S t U ?^ 3 llstm 9- A checksummed hexadecimal file 
n the Intel format can also be produced (of type .HEX). 

b ' s '/,? contams th e assembled machine code The 
assembler can be directed to save the .PRN and HEX 

Drfn S te°r n nr a t ny ^ ailable disk - or f° output them to the 
printer, or to not generate them at all. 

The assembler uses the standard Intel op codes and 
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EDITING LONG FILES 

Files that are too long to fit into the edit buffer can be 
edited in parts. (You may wonder how such a long file 
can be used. As we shall see shortly, the assembler 
operates on a disk source file and puts its results back 
onto the disk. Thus it is possible, in principle, to assem- 
ble huge source files.) The command 200A will copy 200 
lines from the source file into the edit buffer. After edit- 
ing this part, copy it back to disk with the command ffW. 
(There may be more or less than 200 lines after the edit, 
so we use the # symbol.) The sequence of 200A/#W com- 
mands can be repeated as often as necessary. 


the usual pseudo-op codes DB. OS, DW and ORG Both 
the DB and DW directives allow multiple arguments 
whicn may be mixtures of ASCII and constants. 

DB 'Checksum error', CR.LF.'at ’,0 

The ORR pseudb-op has no meaning, since the assem- 
bler doesn’t actually put the resulting machine code in- 
to memory. 

There is also a conditional assembly pseudo-op: 

IF NAME 


ENDIF 

which allows you to maintain one master source file 
containing several versions. For example, my main 
monitor can be assembled with or without VDM capabil- 
ities and with either North Star or PerSci disk com- 
mands. The portion of text between the IF/ENDIF pairs 
is assembled if NAME is true (not zero). Near the top of 
the program, the statement: 

FALSE EQU 0 

TRUE EQU NOT FALSE 

could be given. Then the statement: 

NORTH EQU TRUE 

would cause assembly of the conditional parts headed 

IF NORTH 

but skip assembly of parts headed with: 

IF NOT NORTH 

Labels can contain up to 16 characters and need not 
be terminated with a colon. Imbedded $ symbols are ig- 
nored, and so can be used for legibility. The assembler 
is designed to read free-formatted code, so commands 
can start in any field. More than one statement may ap- 
pear on each line if separated by an exclamation point. 

RAR ! RAR I RAR I RAR :MOVE TO LOWER HALF 

Numerous operations are possible in operands: 


+ 

add 



subtract 


multiply 

/ 

divide 

AND 

logical AND 

OR 

logical OR 

NOT 

complement 

XOR 

exclusive OR 

SHR 

shift right 

SHL 

shift left 


Parentheses can be used to insure the desired hierarchy 
of operations. 

ASSEMBLY-TIME OPTIONS 

Several options can be selected with the assembly 
command: 


command 


A>ASM 

WORK 

A>ASM 

WORK.BBB 

A>ASM 

B:WORK 

A>ASM 

WORK. ABC 

A>ASM 

WORK.BXZ 

The source file must be 


source 

on 

A 

B 

B 

A 

B 


HEX 

on 

A 

B 

B 

B 

printer 


PRN 

on 

A 

B 

B 

C 

none 


.auivi, UUI me .MOIVI 

must not be entered in the command. If all action is on 
the same disk, the file name can be preceded with the 
disk name. An alternate format is also available. The 
location of the source file, and the disposition of the 
HEX and PRN files can be specified by three letters in 
the file-type location. The letters A,B.C and D designate 
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a disk dive. X sends the output to the console/list de- 
vice, and Z indicates that generation is to be omitted. 
The first letter designates the source, the second refers 
to the HEX file, and the third letter is for PRN file. 

A DEBUGGER CALLED DDT 

CP/M comes with a powerful dynamic debugging tool 
(DDT). It is a transient program that is loaded with the 
command: 

A>DDT 

After the prompt — (minus) appears, DDT can be used to 
perform such common monitor functions as: dump mem- 
ory in HEX and ASCII, fill memory with a constant, and 
move a block of memory. DDT can disassemble machine 
code into the 8080 mnemonics and directly assemble in- 
dividual instructions. For example, there is a Go com- 
mand which sets the enable interrupt, and then jumps to 
an absolute address. Before I jump out of CP/M to my 
PROM monitor, I enter a short program with DDT. 


r 





—A F000<CR> 




DKCR> 



: 

JMPF800<CR> 



!*» ■ - •• - 1 ?.. 

<CR> 



L 

— GF000<CR> 




- . 




DDT jumps to F000 where the instructions will disable 
the interrupts, then jump to my monitor at F800. 

An assembled program can be debugged with the 
command: 

A>DDT CERAM. COM<CR> 

The executable program CERAM is loaded at 100 HEX. 
The program counter will initially be set to 100 HEX so 
that a G command (without arguments) will start execu- 
tion of the program. One or two breakpoints can be set 
with the G command, so that the test program can be 
terminated prematurely. All of the 8080 registers can be 
inspected and altered with the X command. There are 
additional commands which allow a program operation 
to be fully traced. 

HEX files are more conveniently loaded with the com- 
mands: 

—I filename. HEX 
— Ra 

where the argument a is an optional load offset. (HEX 
files contain the load address at the start of each 
record.) After assembling my monitor for F800 HEX, I 
can load the resulting HEX file into the beginning of thd 
user's area (100 HEX) with the command: 

— IPRM.HEX<CR> 

— R900<CR> 

FILETRANSFER 

Files can be transferred from disk to disk or from any 
peripheral to any other by using the transient program 
PIP, Forexample: 

A> PIP B:PENCIL.COM = A: 

will copy the binary file PENCIL from drive A to B. 
Notice that the order appears reversed, as with the REN 
command. All files on drive A can be copied to drive B 
with the command: 

A>PIPB: = *.* 


SOFTWARE EVALUATION 


PIP can be used to combine several files into a master 
file. Thus: 

A>PIP B:NEW.FOR = B:SORT.FOR,PLOT.FOR 


will produce a file on drive B with the name NEW. FOR 
from the two files SORT on drive B and PLOT on drive A. 
With this PIP command, you have to be patient. There will 
be disk activity, then nothing for a while, then more disk 
activity. But finally, just when you think the system died, 
the CP/M prompt will appear indicating that all is well. 


GETTING UP AND RUNNING 

It’s easier to get up and running the first time if you 
already have a disk operating system and an assembler. 
You have to write the routines that will interface CP/M to 
your I/O devices. CP/M has the ability to use several peri- 
pherals, such as a video screen, printer, punch, tape 
reader, etc. But it is better to get started with a minimum 
system using only console I/O. Then when you have 
CP/M running, you can use it to generate a more sophis- 
ticated system (BIOS). 

The first thing you should do is make a copy of the 
CP/M diskette, and save the original for a backup. If you 
have only one disk drive, you can make a copy by alter- 
nately transferring portions of the original diskette into 
memory, switching to the new diskette, and copying 
back. If you don’t have a disk operating system, it may 
be difficult to get CP/M running. 

GETTING STARTED WITH THE LIFEBOAT VERSION 

If you have a North Star system, you can get the Life- 
boat Associates version of CP/M running in a matter of 
minutes. Assemble your BIOS for 4400 HEX. Load North 
Star DOS in the usual way, and then switch to the new 
CP/M diskette. Type the command: 

WR284400 2<CR> 


The North Star DOS will copy your BIOS onto the CP/M 
diskette. Now give the command: 


JPE900<CR> 

DOS will jump to the bootstrap loader in PROM and start 
up CP/M. From now on, you can start CP/M by address- 
ing E900. 


FULL-SIZE FLOPPIES 

With an eight-inch floppy disk, you may have a bit 
more work to do. You will need some routines that inter- 
face CP/M to your disk as well as to the other peri- 
pherals. Assemble your BIOS for the address 3E00 HEX 
and copy it onto Track 1, Sectors 18-21 . 

The disk interface programs took me a while to write. 
The problem was with the track- and sector-seek rou- 
tines. CP/M sends its request in binary, and I was using 
a PerSci intelligent interface that wanted ASCII decimal 
input. I therefore had to include a binary-to-ASCII con- 
version routine. Furthermore, both CP/M and the PerSci 
controller perform cyclical-redundancy checks. I sup- 
pose that these factors are partly responsible for the 
noticably slow operation. The controller comes with a 
serial option that also causes a slowdown. (1 understand 
that PerSci has a new version of its DOS available that 
accepts binary input and is designed for parallel opera- 
tion only. This should make interfacing easier, and 
perhaps increase the speed.) , 

It looks like one of the dumb-interface boards avail- 
able from Tarbell or S.D. Sales is a good way to go 
These apparently come with software (or firmware) that 
should make it much easier to get CP/M going. I will 
have the Tarbell unit shortly, and will devote an article to 
it i n a forthcoming issue. 
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ENLARGING THE SYSTEM 
CP/M does its work in the transient program area 
(TPA) between 100 and 28FF HEX. If you have more than 
the minimum memory, you should enlarge CP/M so that 
it will have more work space. This is easily accomplished 
with the routines on the CP/M diskette (if you don't 
follow the confusing instructions in the manual). There 
are several ways of accomplishing the expansion; the 
more sophisticated, use CP/M entirely. 

I did the enlarging before I was familiar with all the 
CP/M commands, so it isn't the most efficient. Never- 
theless, since I was able to accomplish the task, I will 
show you how it can be done on the North Star system. 
You will need an initialized diskette, and the best way to 
get one is to make another copy of CP/M. 

To generate a nominal 46 K system (which requires 
50K of memory), type: 

A> NRELOC 46* 

The system responds with: 

CONSTRUCTING 46 K CP/M 
READY FOR “SYSGEN" OR 
"SAVE 38 CPM46.COM" 

Now type: 

A>NSYSGEN 
and you get: 

SYSGEN VERSION 1.1 

GET SYSTEM? (answer N) 

PUT SYSTEM? 

Answer Y if you have more than one disk and put an ini- 
tialized diskette into drive B. If you have only one drive, 
answer A and replace the 16K diskette with an initialized 
diskette. A verification message appears next: 

SOURCE ON B (or A], THEN TYPE RETURN (do it) 
FUNCTION COMPLETE 
REBOOTING, TYPE RETURN. 

If you typed an A to the PUT SYSTEM? command, switch 
back to the 16 KCP/M diskette before typing return. 

The new version of CP/M won't run yet because it 
doesn t have your customized BIOS. Reassemble your 
I/O routines to run at the new address: 

MSIZE* 1024 + 400H (Lifeboat version) 

where MSIZE is the new nominal size in decimal K (46 in 
the above example). Copy the reassembled BIOS to ad- 
dress 28 as you did at the very beginning. Now a cold 
start (jump to E900) will load the new, larger system. 

If you have an 8-inch floppy, give the commands: 

A>CPM 46 * 

A>SYSGEN 

rather than NRELOC and NSYSGEN. Reassemble your 
BIOS to: 

MSIZE* 1024 — 200H (8-inch disk) 
and copy it to T rack 1 , Sectors 18-21. 

CONVERTING YOUR OLD SOURCE PROGRAMS 
You can copy your old assembly language source 
files to CP/M disk files, and then assemble them after 
making a few alterations. The CP/M editor stores both a 
carriage return and line feed at the end of each line. My 
MITS source files contain only a carriage return. 
Furthermore, CP/M expects a pair of apostrophes to 
delimit ASCII characters, but my old source files use 
quotation marks. 

The CP/M editor can insert a carriage return/line com- 
bination, but it can’t insert just a line feed. Therefore, I 
had to preprocess my source files. The easiest way to- 
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make the conversion is to replace all line feeds with 
something else not used in the text (e.g., a # symbol). 
Then copy the file to CP/M and use the S command to 
replace the # with the CR/LF pair (where 'L stands for 
CR/LF). I couldn’t do this at first, since my monitor uses 
A L to sv/itch output to the list device. 

The program shown below will add a line feed after 
each carriage return and will also change each quote to 
an apostrophe. I used my North Star DOS to load the file 
into memory starting at 4000 HEX, then jumped to my 
monitor and block moved the source program to 2CC0 
HEX. ! started up CP/M and executed my ADDLF. 

A>ADDLF 


! PROGRAM TO ADO LF* TO HITS SOURCE PROGRAMS 
I APRIL 14. 1973 
ORG lOOH 


OLD EOU 2COOH 

NEU EOU 2200H 


.’START OF OR I GINA! 

J START OF NEU VERSION 


0100 . 1 1002C 
0103 210022 

0106 1A 

0107 f E22 
O10» C2CE01 
C10C 3E27 

01 .£ -7 

oic* :3 
o::: feo? 

0112 DA2101 
OHS 23 


“Soo 

0113 C 20601 
011S 3oOA 



start: lxi 

LXI 

next: ldax 

cpi 

JNZ 
MV I 

skip: mov 

I NX 
CPI 
JC 
I NX 
CPI 
JNZ 
MVI 
INX 
JMP 


D.OLD SOLD POINTER 

H.NEU i NEU POINTER 

9 !GET A BYTE 

**' (LOOK FOR OUOTE 

SKIP 

A. 39 . CHANGE TO ' 

M.A (PUT INTO NEU FILE 

:< {INCREMENT POINTERS 

2 {LOOK FOR 0 OR 1 

CONE 

vDH .'CARRIAGE RE TURN** 

NEXT {NO 

M.10 JPlir LINE FEED IN 

H { INCREMENT POINTER 

NEXT INEX! BYTE 


o::: 

0123 


pone: 


• AH {pill "7 AT EMI. 

CFflOOH {JUMP TO PR|)M 


ADDLF will copy the source file starting at 2C00 to 2200, 
making the necessary changes until either a binary one 
or zero is found. (I use a binary one for an end-of-file 
(EOFi marker). ADDLF puts a 1A HEX ( A Z), the EO c 
marker for CP/M. at the' end. When ADDLF is done (it 
takes only seconds), it jumps to my monitor so that I can 
inspect the new file and block move it down to 100 HEX. 
A jump to address zero will restart CP/M so that the con- 
verted source file can be saved. The command: SAVE 20 
filenarne.ASM will copy a 20-block file to the default 
drive. There must be an easier way, but at least this 
method works. 

PROGRAMSTHATRUN ON CP/M 

There are several intersting programs designed to run 
with CP/M. No modification is necessary; just put the 
diskette in and type the program name. Three BASICS 
are available: BASIC-E, CBASIC, and Microsoft BASIC. 
The first two compile your source program from disk 
and put the resulting code back onto disk. The compiled 
code should run much faster since instructions in loops 
aren't continually being re-interpreted. Also there is no 
need for a 12K or 16K BASIC to be taking up memory. 
The disadvantage of a compiled code is that it may be 
harderto debug. 

The Microsoft BASIC appears to be a CP/M version of 
MITS disk BASIC. Microsoft also has a CP/M version of 
FORTRAN that sounds yummy. It would certainly make 
data reduction in our thermodynamics lab easier. 

1 expect to have BASIC-E, a macro assembler called 
MAC and a debugger called SID running shortly; I will 
give you a report on them in the near future. 

Next month I will report on the CP/M version of 
Michael -Shrayer’s Electric Pencil, a very versatile para- 
graph-oriented text editor. I used Electric Pencil to com- 
pose, edit and format this CP/M article. □ 
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TMS 9900 Interactive Monitor 

— Part 11 


By Burt Johnson 

In Part One of this article. I discussed the general philosophy and design of the 9900 monitor. In this part the 

unassembled listing is provided for those readers who wish to emulate the design. 

Table 1 is a review list of all the functions provided within this monitor. Table 2 is a summary of the commands available. 
I believe that those of you who have 9900 based machines will find this an extremely useful tool to use as is, or in the 

development ot your own interactive software. PROGRAM LISTING 

VARIABLE DEFINITION 
INTERRUPT VECTORS 
MAINLINE 

hANDLERS FOR QUICKIE COMMANDS 
TRACE CONTROL 
LIST (DIS-ASSEMBLE) 

GENERAL SUPPORT ROUTINES 
DOWNLOAD FROM HOST COMPUTER 
INTERRUPT HANDLE=S 
RXXX - PRINT STATUS. REGISTER 
OPCODE HANDLERS FOR OUTPUT 
ASSEMBLY INPUT 

ASSEMBLY INPUT TYPE HANDLERS 
=ARSE INPUT FOR ASSEMBLER 
~S FLAG HANDLER FOR OUTPUT 
TABLES 
CONSTANTS 
OPTIONAL TABLE 

OPTIONAL COMMAND PROCESSORS 
DECIMAL INTEGER PRINT 
DECIMAL TO HEX AND HEX TO 
nANDLE AUTO-HARDCOPY 
3AM TEST WITH WALKING ONES 
OUTPUT EXECUTION TIME AND MEMORY 
°APER TAPE SUPPORT 
TIMING TABLE 

Table 1. 


E1U T 
flU S 

nu 9 

ecu u 

SOU 11 
STJ 12 
SVJ 13 
E3U 1* 

EOU 15 
E1U *‘653 
EOU *0403 


LOCATION OF <P RAN SLOCK 
ASCII CARRIAGE RETURN-LINE FEE 0 

OAT* RECIE/E3 FROM EITHER TERMINAL 0® <®ON0S 
U IT « ON = HT * HIT 
HAINLINE 
HP FOR INT? 

HP FOR INTI 
SUPPORT ROUTINE HP 
LAPCE S'J»®:®T ROUTINE HP 
OECO'IING H® 

PR0K-3AVINS ROUTINES 
TERMINAL I/O HP 

sssu :i s ,2 s ;r* 

KRONOS ONsi: 3FF=0 
USER HP ON RETURN CM) 

USER PC CN RETURN (-> 

USER ST ON RETURN <0» 

AC0R‘SC F0 S BREAKPOINT LATCH TO 03SER {= C II 

NUHBER OF TINES TO PASS BREAKPOINT « , N* , 51 
NUMBER TERMINATED BY , (MSA> 

NUMBER TERMINATED 3Y 1 «MEAI 

I=ALL REG: -t=JUMP: 1=0UICK (S.J. *nd T> 

SAME AS 4B3VE ON PER INSTRUCTION BASIS 
COMMAND COUNT (NUMBER TERMINATED 3T I0-NAN0I CN*T1 
COUNT PRINTED CHARACTERS TO ALLON TABBING 
REFERENCED SYMBOLIC AOORESS IN OECOOIN" 


INT20AT BS; l 
INTFLAG 3SS 2 
WP00T99 391 32 
WPINTZ 39S 12 
UPINT3 3SS 32 
HP9UG2 9SS 32 
NP3UGJ 3SS 32 
HPBUG4 3SS 32 
HP5UG5 3SS 32 
WPTPMNL RSS 32 
USERHP BSS 32 
HPHOLD BiS 66 
KRCNOS 3SS 2 
USRWP I 3SS 2 
USRPC 3SS 2 
USRST 3SS 2 
BRKPNT 3SS 2 
3RKPASS 9S3 2 
EOITt 3SS 2 
E0IT2 3SS 2 
TRACTYP 9SS 2 
TR4CPRN 3SS 2 
COUNT 9SF 2 
TAR 3SS 2 
H0R01 9SS 2 
W0P02 3SS 2 
HOP 01 9SS 2 
H0P04 3SS 2 
OLATNP 9SS 2 
OLALOP BSS 2 
LINE BSS 2 
OELATIM BSS 2 
HAROCP 9SS 2 
MASSHEM BSS 2 
OPTIONS BSS 2 
HALTAOO 3SS 2 
SPEEO BSS 2 
ACCESS 3SS 2 
BUST2 BSS 2 
HEXOST EOU 3E01S 
BREAK E1U SE01A 
TOUART EOU SE01C 
TCU ART SOU TOUART *S10C 
KOUART EOU SE01E 
KCU ART EOU KOUART >1100 
TAPCUART £QU TCUART 

TAPOUART EQU TOUART 

RST8P EOU l BREAKPOINT RESET CRU LINE 

NAM inTERUPT VECTORS 


SAME AS -:®oi 

SAME AS H0R01 

COUNTER F0» 1ELAT 

INTERNAL S.SSP COUNTER FOR DELAY 

LINE COUNT FOR PAGE <HI 

LOOP CELAY COUNT AFTER OUTPUTING L c TO 

<>0 IF AUTC-MAROCOPY REOUESTEO * •*•■( 

<>0 IF ALL OUTPUT TO GO TO KR0N09 «•! 

< >0 IF OPTIONAL TABLES EXIST 

HALT ACORESS FOR STEPPING IN) 

NUMBER CYCLES FOR EXECUTION (V) 

NUMBER -C-0RY ACCESSES FOR EXECUTION 

Busrz c la*i :j ignope terminal curing s: 
AOORSSS 3 s HE* LEO ON TET ROARC 
ACORESS C c BREAKPOINT LATCH 
AOORESS 0** TERMINAL DATA UART 
AOORESS OF TERMINAL CONTROL UART 
AOORESS OF KRONOS DATA UART 
AOORESS OF <R0N0S CONTROL UART 


1MANDS SUMMARY 


ss BACKSPACE NUMERIC ENTRY (CONTROL-HI 

vuvu NNNN KKKKZ SET ADDRESS SPACE MMMM TO NNNN EQUAL TO 
HEX VALUE KKKK 

UWV f.NL LIST NN INSTRUCTIONS 3V MNEMONIC 
AL’VOCe iMOOE SWITCH) - 
KSCNOS = = DDT99 

DDT99 = = ASM 

ASM = = DDT99 

MUWMO SET USER STATUS TO MMMM 

MVWM NNNN.KKKKM START RAM TEST FROM ADDRESS MMMM TO NNNN 
• -» DELAY KKKK LOOPS BETWEEN WRITE AND REAO SEQUENCES TO 
TEST DYNAMIC RAM REFRESH CIRCUITRY 
CH TURN OFF AUTO HARDCOPY MOOE (OR JUST H I 

TURN ON AUTO HARDCOPY MOOE lOR ANY NON ZERO DIGIT FOLLOWED BY 
X COLDSTART DDT99 RESETTING ALL VARIABLES 

MMUUN STOP TRACE AT ADDRESS MMMM EVEN IF NN INSTRUCTIONS HAVE NOT 
BEEN COMPLETED 

V START TIMING IF PRESENTLY OFF OR • PRINT PRESENT TIME AND 

TERMINATE TIMING MOOE IF PRESENTLY ON 
NV FOR NON ZERO N. PRINT PRESENT TIME AND CONTINUE TIMING 

NNNN5 CONVERTS HEX TO DECIMAL AND DECIMAL TO HEX 
MMMM. NNNN. • CNTL-P PUNCH PAPER TAPE OBJECT CODE 

FROM ADDRESS MMMM TO NNNN 

• CNTL-P-' READ PAPER TAPE OBJECT CODE IN • CNTL-P • FORMAT 


HOSO HPOOT99, INTI 11 

HO PC HPINT2.INT2 12 

HOSO WPINT3.INY3 13 
HAH HAINLINE 
DBG XF000 

JMP START EASY USE* RETURN 

COLDSTR JHP RESTRT _ 

TOPHFN NOV UINIT, TCUART INITIALIZE UARTS 
NOV CTLUART.TCIIAPT 
NOV UINIT. KCJAOT 
NOV CTLUART. KCU ART 
RESTRT NOV Cl. BRKPNT TURN OFF 

NOV Cl. BREAK TURN OF- 3PEAKP0 

LWPI HPOOT99 FORCE CORRECT HP 

LI RO. USERHP 

NOV RJ.USRHP DEFAULT USER STA 

NOV CO. USRST 
CLP 3USY2 
CLR OELATIH 
CL» SPEEO 
CLP COUNT 
CLR HAROCP 
CLR NASSNEM 
CLR OPTIONS 
C SEaOfc.HELLOl 
JNE NOOPTS 

C t£«36.HiLL02 VERI e Y IT 
JNE NOOPTS 
INC OPTIONS 
NOOPTS "LHP NESAS 
HORO CRLF 
FCC •Vl.Z* 


TOP OF *1SS 

3®FAULT TO NO AUTO-COPY 
DEFAULT IS NOT TO SENO TO « 
OEFAULT TO NO OPTION TABLE 
IS THE TABLE THERE? 


NAM VARIABLE DEFINITION 
EOU 0 
ECU 1 
EOU? 


THE TABLES OO EXIST 
GIVE SALOTAION 


Table 2. 
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